home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / telecomm / flashupd.arc / UPDATE.DOC < prev    next >
Encoding:
Text File  |  1985-11-20  |  12.0 KB  |  265 lines
  1.                   Instructions for Flash 1.51 update file.
  2.  
  3. There are three files in this archive: UPDATE.DOC, UPDATE.PRG, and
  4. UPDATE.DAT.  You are reading UPDATE.DOC.  UPDATE.PRG and UPDATE.DAT are used
  5. to convert FLASH version 1.51 to version 1.52.  UPDATE will only work with
  6. version 1.51, if you have an earlier version, you can get an update by
  7. sending your original disk to Antic, Attn: FLASH Update, along with $5 for
  8. shipping and handling.
  9.  
  10. Further on we'll describe the changes in Flash 1.52.  Meanwhile, here's how
  11. to do the upgrade:
  12.  
  13. Place UPDATE.PRG, UPDATE.DAT, and _a back-up copy_ of FLASH.PRG version 1.51
  14. on the same disk (or in the same folder of a hard disk).  (FLASH.PRG version
  15. 1.51 will be exactly 128,268 bytes long.)  Double-click to run UPDATE.PRG;
  16. the update procedure will take a few moments to complete.  When your update
  17. is completed, you should now have an additional file called FLASH152.PRG
  18. that should be 131,924 bytes long.  If you wish, you may rename this to
  19. FLASH.PRG.  Transfer FLASH152.PRG to whichever disk contains your FLASH.RSC
  20. and other working files.  You're all set!
  21.  
  22. NOTE:  Hang on to your original FLASH 1.51 program in case we upgrade
  23. UPDATE.PRG.
  24.  
  25.     Flash 1.52 adds some new features to Flash 1.51, including an ARC
  26. command for calling the arc.ttp program directly, the new B-PLUS file
  27. transfer protocol for CompuServe, extra commands for remote operation, and
  28. much faster DO file operation. A few minor bugs are also fixed. The update
  29. program will convert your copy of Flash version 1.51 completely to version
  30. 1.52. You use the original Flash 1.51 resource file with the updated
  31. program.
  32.  
  33.                             FLASH 1.52 Features
  34.  
  35.       Flash 1.52 is a minor upgrade from the original Flash 1.51. The main
  36. improvements are faster DO files, B-PLUS protocol, extra commands for remote
  37. operation and an ARC command. There are also a number of bug fixes.
  38.  
  39.  DO file improvements
  40.  
  41.         I realized suddenly that with a few tricks I could make DO files run
  42. two to three times faster by speeding up the display of commands on the
  43. command line. A feature of this is that during the process of displaying
  44. each command from a DO file on the command line, no input from the serial
  45. port is processed. This is useful so the DO file won't miss any characters
  46. on a WAIT command.
  47.  
  48.         There is a slight change to the Flash ALERT command. You can now put
  49. an optional  numeric parameter after the variable to indicate the default
  50. exit button that will exit the alert when you press 'return'. e.g.
  51.  
  52.  >alert "[1][This is an alert][OK|2nd|3rd]" $A 1|
  53.  
  54. 0 is no default exit button, 1,2, or 3 sets the default exit button to the
  55. first, second, or third button.
  56.  
  57.         Some people want to be able to compare two string variables with the
  58. IFI command, but it failed because in something like:
  59.  
  60. >IFI $A $B TYPE "SUCCESS"|
  61.  
  62. $A was being compared to the two letter string '$B' and not the contents of
  63. the variable $B . This was not really a bug, but laziness on my part. This
  64. is now fixed.
  65.  
  66.         I can't believe I forgot to include a method of getting remote input
  67. into a string variable in Flash 1.51. I have added one new command to fill
  68. this gap:
  69.  
  70. >GET $X n|
  71.  
  72. will get a line of input from the serial port into variable $X (or whatever
  73. variable you specify) with a timeout 'n' in seconds, where n is a number
  74. from 1 to 9999. If no timeout is given, the default is two minutes.  Several
  75. people have requested this type of command as they want to try writing their
  76. own remote control DO file.
  77.  
  78.         To enhance the ability to do remote control access through DO files,
  79. I have adjusted the DDIR [path] [file for output] command so that if you
  80. specify a filename of AUX: for output, the directory will be transmitted out
  81. the serial port, e.g.,
  82.  
  83. >SEND "Pathname:"|
  84. >GET $A|
  85. >DDIR $A AUX:|
  86.  
  87. would prompt a remote user for a pathname and then send the directory the
  88. user asked for out the serial port, formatted for 80 columns. Any key (from
  89. remote) pauses, when paused, any key continues.
  90.  
  91. NOTE: For proper use, I assume that ECHO and LF are ON for the GET command
  92. so that the remote user gets to see what he/she types in properly. If you
  93. want to design a remote user interface using a Flash DO file, use the
  94. commands:
  95.  
  96. >LF ON|
  97.  
  98. and
  99.  
  100. >ECHO ON|
  101.  
  102. as soon as you get a connection. A recommended method would be:
  103.  
  104. >WAIT CONNECT|
  105.  
  106. then test carrier detect with:
  107.  
  108. >IF CD
  109.  
  110. If you get a carrier, then turn LF and ECHO on. Warning: if you turn echo on
  111. before the modem has connected, then Flash will echo all modem responses and
  112. you will get nonstop characters.
  113.  
  114.         Another tiny change I made to enhance remote operation was in the
  115. SEND command. Normally, a '|' in the SEND command gets translated into a
  116. carriage return. In the case that the LF setting is ON, the '|' characters
  117. now gets translated into carriage return + line feed. This would be
  118. convenient if you wanted to send a remote user a menu. Otherwise, with 1.51
  119. you would have to imbed actual carriage return and line feed characters in
  120. the SEND string or waste a string variable by making it equal to carriage
  121. return + line feed. Both these options would be rather annoying.
  122.  
  123. B-PLUS protocol added
  124.  
  125.       Flash now has a fairly complete implementation of the B-Plus file
  126. transfer protocol. The improvements over standard B-Protocol and Quick-B are
  127. (1) the use of a CRC checksum for improved error detection and (2) block
  128. send-ahead for faster uploads. B-Plus is indicated during file tranfers by
  129. 'B-P+' instead of 'B-P' on the command/status line.
  130.  
  131.       As far as I know, Flash is the first ST telecom program to include
  132. B-Plus. I have not implemented some features of B-Plus, namely 1K blocks and
  133. extended character quoting. The disadvantages of 1-K blocks on noisy phone
  134. lines appear to outweigh the minor improvement in transfer speed that might
  135. result.
  136.  
  137. 'GEM' command sets path
  138.  
  139.         When using the GEM command to execute a GEM program, Flash will
  140. automatically switch to the drive and path that the program is located in so
  141. that it can find its resource file properly. When it returns, the path is
  142. set back to the default path.
  143.  
  144.         I am so used to typing 'cd' for setting default path, instead of the
  145. Flash 'dp' command, that I tend to do it unconsciously. I have adjusted
  146. Flash so  that it recognizes 'cd' the same as 'dp' for those of you who are
  147. used to command shell programs with this syntax..
  148.  
  149. New 'ARC' command
  150.  
  151.          I have added 'ARC' as a command in Flash. All you need to do is put
  152. a copy of ARC.TTP in the SAME DRIVE AND FOLDER that you run Flash from.
  153. Flash remembers the drive and folder that it is run from and then will
  154. always use this path to call arc, even if you have changed default paths in
  155. the meantime. Example: if you want to find the contents of the archive
  156. 'update.arc', type ARC V UPDATE on the Flash command line.
  157.  
  158. Other changes
  159.  
  160.         VT100 fix. Most IBM protocol VT100 convertors seem to draw text on
  161. the screen with cursor positioning commands and hardly ever use carriage
  162. returns and line feeds. This makes a real mess out of the capture buffer,
  163. usually leaving everything on one or two lines. I have added code that will
  164. hopefully add the necessary carriage returns/line feeds as well as
  165. additional spaces if there is a cursor position command in the same row but
  166. different column. This has not been tested very much, but I did not want to
  167. delay releasing Flash 1.52 since only a handful of people requested this
  168. feature. If I have to make further changes to this code, I will release a
  169. revised update patch file. Be sure to save your original Flash 1.51 program
  170. just in case.
  171.  
  172. Further additions
  173.  
  174.         In the capture buffer editor, Clr/Home key moves to the beginning of
  175. the buffer, shift-Clr/Home moves to the end of the buffer.
  176.  
  177.         When you select loading the buffer (from the menu bar) and there is
  178. already text in the buffer, you get an alert box warning you about this, in
  179. case you meant to select MERGE instead.
  180.  
  181.         Control characters now pass through immediately in type-ahead mode
  182. instead of getting show on the typeahead line as graphics characters.
  183.  
  184. P.S. If you develop any DO files that use the new GET command or rely on any
  185. of the changes in Flash documented here, please note what version of Flash
  186. is required to use the DO file(s) to avoid frustration.
  187.  
  188.  Bug fixes
  189.  
  190.        Yes, there were a couple of bugs in 1.51, fortunately they were not
  191. fatal ones, just minor glitches. For the curious, here are some of the most
  192. noticable bug fixes:
  193.  
  194.        If a disk error occurred during file transfer, in some cases the
  195. alert box would appear but no mouse cursor. This has [hopefully] been
  196. fixed.
  197.        Nobody ever pointed this one out, but if the buffer was fairly full,
  198. then the line count at the top was not getting updated continuously, but
  199. only if the window slider box moved. Now it updates continuously.
  200.        If someone type DL XM filename from the command line and the file
  201. already existed, then they would get an alert box asking them if they wanted
  202. to cancel the download or not. The bug was that no mouse was present.
  203.        There were some areas where unattended DO files would fail because
  204. alert  boxes would pop up. e.g. XD would not exit from Flash due to the
  205. alert box, if the capture buffer was full, then an alert box would appear
  206. and an alert would appear if the printer wasn't ready. This was more of an
  207. unforseen design flaw than an actual bug.
  208.        These alert boxes will now not appear if a dofile is active. Note
  209. that even in 1.51 the system disk error alerts are turned off during DO
  210. files to avoid DO files getting hung up in them.
  211.        Nobody has ever complained about this, but in echoplex Flash will
  212. echo XON and XOFF [control-q and control-s]. This doesn't cause a problem if
  213. two people with Flash are connected, but could cause a problem with some
  214. programs. So, I have disabled echoing of XON and XOFF in echoplex as a
  215. precaution.
  216.        I have fixed the menu-frozen bug. In 1.51, sometimes the menu bar
  217. wouldn't drop down till you clicked on the mouse button and moved the mouse
  218. a bit. It happened rarely, and only cropped up after you switched from
  219. terminal to capture buffer.
  220.        Some programs exit without closing and deleting windows! This totally
  221. screws up when you go into menu mode and want to fet back into terminal
  222. mode. It's also sloppy programming. Now I check for left over windows after
  223. the EXEC or GEM command and close and delete them.
  224.        Bug in EXEC. It was failing to properly add '.TTP', '.TOS' or '.PRG'
  225. to  program names under certain circumstances. This meant that >EX ARC v
  226. junk| would not work even if ARC.TTP was in the default path. Flash should
  227. have added '.TTP' automatically.
  228.        If you dragged the vertical slider to the top and had a LOT of text
  229. in the buffer, it would not go right to the top, but a few lines below.
  230. Fixed.
  231.        There was an inability to handle long lines for SEND and TYPE
  232. commands in DO files. Now this is changed so you can have up to 100
  233. characters in SEND and TYPE commands in DO files and Flash will process them
  234. properly, even though they are too long to fit on the command line.
  235.        I have also made some minor changes to EXEC function that should
  236. hopefully solve a few wierd incompatiblility problems with programs that
  237. reset clipping or zap the vblank routines.
  238.        There was a bug all along such that when you print a block or the
  239. buffer and the printer is not connected or turned on, the alert warning you
  240. of that would not appear. Fixed.
  241.        I found and fixed a rather obscure bug involving the slider. It
  242. happened if you held down the mouse on the shaded vertical scroller bar
  243. until the slider moved down or up to where the mouse was located. In some
  244. cases, only the top four lines of the screen would be updated and the rest
  245. of the lines would be the previous screen. As soon as you start to type on a
  246. line, it would update with the 'real contents. Note: This was a display
  247. glitch only. It would NOT cause Flash to crash.
  248.  
  249.               -- Alan Page
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.